home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / LABLER84.ARJ / LABLER.DOC < prev    next >
Text File  |  1992-02-22  |  27KB  |  574 lines

  1.                  ╔══════════════════════════════════╗
  2.                  ║            LABLER v8.4           ║
  3.                  ╚══════════════════════════════════╝
  4.                  Ken Koch (c) 1989, 1990, 1991, 1992
  5.  
  6.         DISCLAIMER OF WARRANTIES AND LIMITATION OF LIABILITIES
  7.         ------------------------------------------------------
  8.         The author has taken due care in writing this program,
  9.         and the program is supplied as is.  The author makes
  10.         no expressed or implied warranty of any kind with regard
  11.         to this program.  In no event shall the author be liable
  12.         for incidental or consequential damages in connection
  13.         with or arising out of the use of this program.
  14.  
  15.  
  16.         This program is NOT public domain.
  17.  
  18.         It may be distributed and used free of charge by anyone,provided:
  19.  
  20.         1.      No charge is made for this program other than a
  21.                 minimal charge for the blank disk, postage, etc...
  22.  
  23.         2.      Both the software LABLER.EXE and this short
  24.                 documentation file LABLER.DOC are distributed
  25.                 together and un-altered.
  26.  
  27.         3.      This software is not distributed in a manner to
  28.                 provide "added value" to a commercial product
  29.                 which is being sold for profit.
  30. -----------------------------------------------------------------------------
  31. Included In This Package
  32. ------------------------
  33. Filename       Original
  34. ------------ ----------
  35. 67CONVER.EXE      13552....for Converting Pre-7.0 lists to v7.0 lists.
  36. 78CONVER.EXE      56208....for Converting Pre-8.0 lists to current format.
  37. LABLER.EXE       109648....Main Program.
  38. LABMAINT.EXE      64672....List Maintenance program. (Sort/Delete)
  39. LABLER.DOC        26363....This DOC file
  40. LABLER.SDR          432....\ Sample Graphics Library
  41. LABLER.SHP        15579..../
  42. -----------------------------------------------------------------------------
  43.  
  44.  
  45.  
  46. Purpose
  47. -------
  48.         LABLER is a labeling program. (the program is not misspelled, just
  49.         wanted a different way to have people remember it better.)
  50.  
  51.         LABLER, will print as many labels to a printer as long as the
  52.         printer is EPSON or IBM compatible, and of course there is an
  53.         ample supply of labels.
  54.  
  55.  
  56.  
  57. Legend
  58. ------
  59.  
  60.             ┌──Current Time     ┌─Editing Lines (1-5)
  61.             │                   │
  62.             ⌐                   │
  63.   ┌──────────────────────┬──────┼───────────────────────────────────────────┐
  64.   │ Time : 11:00:00 a.m. │      │            LABLER v7.4                    │
  65.   ├──────────┬───────────┴──────┼─────────────────────────────────────┬─────┤
  66.   │LINE  MODE│ LINE CONTENTS    │                                     │LINE#│
  67.   │──────────┼──────────────────┼─────────────────────────────────────┼─────┤
  68. ┌>│██Normal██│░░░░░░░░░░░       ⌐                          ░░░░░░░░░░░│██1██│<┐
  69. │ │  Normal  │░░░░░░░░░░░          Maximum Ending Position>░░░░░░░░░░░│  2  │ │
  70. │ │  Normal  │░░░░░░░░░░░                                  ░░░░░░░░░░░│  3  │ │
  71. │ │  Normal  │░░░░░░░░░░░<Minimum Starting Position        ░░░░░░░░░░░│  4  │ │
  72. │ │  Normal  │░░░░░░░░░░░                                  ░░░░░░░░░░░│  5  │ │
  73. │ ├──────────┴──────────┬───┬───┬─────────────────────────────────────┴─────┤ │
  74. │ │  Press F8 For Help  │ G │ S │        By Ken Koch (c) 1991               │ │
  75. │ └─────────────────────┴───┴───┴───────────────────────────────────────────┘ │
  76. │                         ^   ^                                          ┌────┘
  77. └─Mode                    │   │                                          │
  78.   Indicator               │   └─Sound Indicator                        Line
  79.                           │                                          Indicator
  80.                           └─Graphic Mode Indicator
  81.  
  82.  
  83. Getting Started
  84. ---------------
  85.  
  86.         Type:
  87.                 LABLER [optional list name] [switches]
  88.  
  89.         When LABLER is first called, it will create a Label list called
  90.         LABLER.LST unless it is already in the current directory. This
  91.         LST file not only hold labels, but any configurations you have
  92.         made.
  93.  
  94.         Command Line options:
  95.         --------------------
  96.  
  97.         /S ... Setup
  98.         /Lnnnn Create List file with nnnn entries. Default is 1000.
  99.                (Must be between 1-1000)
  100.  
  101.         LABLER <list name>
  102.                 This will load a particular Label list at
  103.                 runtime. The default list is LABLER.LST
  104.                 When giving the name, do not include the .LST
  105.                 extension as it will be automatically appended
  106.                 to the name you choose.
  107.  
  108.  
  109. Setup
  110. -----
  111.         Specifying /S on the command line, will present you with the
  112.         Labler setup screen. Here you may change 5 things.
  113.                 1. Type of screen:
  114.                         1. Color
  115.                         2. Composite
  116.                         3. Mono
  117.                 2. NextLabel value - this value, in increments of
  118.                    1/72", is the spacing required between labels.
  119.                    The default is 5.
  120.                 3. Sound toggle.
  121.                 4. Backgrounds
  122.                         1. None - use whatever is on screen at time
  123.                                   of execution.
  124.                         2. Yes w/ANSI screen. Use LABLER.ANS. If it
  125.                            does not exist the default NORMAL background
  126.                            will be used.
  127.                         3. Yes w/Normal Background.
  128.                 5. Erase screen upon exiting.
  129.  
  130.  
  131. Notes
  132. -----
  133.         In record 0 of the list file, the configuration of LABLER is
  134.         stored. If you don't have a previous version of LABLER, & a
  135.         LABLER.LST is to be created, you can specify how many labels
  136.         will exist in the list by giving the /Lnnnn switch. When
  137.         specifying the number, and it's below 1000 you must pad that
  138.         number with 0's. ie. 500 = 0500. You can specify any number
  139.         between 1 - 1000. If a list is created less than 1000, you
  140.         can still save more labels in the list, than you initially
  141.         created it at. For this program to function corectly you must
  142.         be in the same directory as the LABLER.LST file.
  143.  
  144.         When you first run LABLER, it will create the default label list
  145.         called LABLER.LST, unless one is already there (from a previous
  146.         version.) If you have one from a previous version, run the
  147.         included program 67CONVER which will convert pre-7.0 lists to
  148.         this version. The sytax to use for 67Conver is:
  149.  
  150.           Use:      67CONVER [.LST name] to convert from Pre 7.0 lists
  151.                                          to Labler v8.x lists.
  152.                     78CONVER [.LST name] to convert v7.x lists to
  153.                                          Labler v8.x lists.
  154.  
  155.         If you do not give it a list name, it will use the default of
  156.         LABLER list. Do not worry if you run this program again using
  157.         the default. If it has already been converted, the program will
  158.         abort. The conversion takes roughly 2 minutes so it might be a
  159.         good idea to maybe Grab a cup of coffee in the interim. Also you
  160.         will need at least 2 * the size of the list file in bytes to
  161.         run the conversion.
  162.  
  163.         When Labler is finished making or reading the list, the setup
  164.         screen will appear. After making any changes to the setup, you
  165.         will then be presented with the normal Labler edit window. If
  166.         at any time you wish to redo any of the setup options, ESC out
  167.         of the program & run the /S option switch.
  168.  
  169.         If your printer is NLQ compatible, you can use NLQ if this function
  170.         is enabled before running LABLER, on your printer.
  171.  
  172.         ** Note for NLQ **
  173.         Remember that with NLQ mode you cannot write condensed NLQ. If you
  174.         wish to use condensed in a label, the NLQ must be disabled. Also
  175.         with the graphics in this version, if you are using graphics in a 
  176.         label, NLQ must be disabled.
  177.  
  178.         LABLER, will print 5 lines only. So the perfect labels would be the
  179.         1x3" kind. It also inserts 1 blank line between labels. Some align-
  180.         ment of the printer head may be needed, for optimum performance.
  181.  
  182.         In this Version I have updated the way to enter the SAVE or LOAD
  183.         prompt. You need only press S or L depending on the function wanted
  184.         rather than pressing the RETURN key afterwards. To abort this
  185.         function just press any key except "S" or "L".
  186.  
  187.  
  188. ANSI Screen Background
  189. ----------------------
  190.         You can create a custom background for the LABLER window to sit
  191.         on. Just create an 80x25 ANSI screen using any ANSI screen creator,
  192.         & name it LABLER.ANS. When LABLER is invoked it first searched for
  193.         this file. If one is not found, then the default screen is used.
  194.         You must have ANSI loaded, and a Color monitor present. If you have
  195.         a LABLER.ANS file, but wish to use the default screen, specify
  196.         the /NA option switch, which will not load it. If you are using
  197.         the ANSI screens, and it does not work, use the DOS commands
  198.         MODE CO80 before using LABLER. Some programs modify the memory
  199.         location that holds the value to indicate that ANSI is loaded.
  200.         If you wish to use another ANSI screen other than LABLER.ANS,
  201.         first type it to the screen, then use the /NB switch, which will
  202.         use the startup screen.
  203.  
  204.  
  205.  
  206. Function Keys within LABLER
  207. ---------------------------
  208.    F1...Toggle Normal, Condensed, Underlined and Enlarged modes.
  209.         Note: If the length of the line you are toggling is greater
  210.         then the allowable length for that mode, you will be advanced
  211.         to a mode that will allow that length.
  212.  
  213.        (ENLARGED Mode:
  214.         This is for printers that will do ENLARGED printing based
  215.         on the printer codes: chr$(14). In Enlarged mode, you will
  216.         only get 17 characters to print out, so if you have more than
  217.         17 characters on a line and to go into Enlarged mode, it will
  218.         not do so, until you get rid of some of the letters. 
  219.  
  220.         If in Graphics mode, Enlarged Mode decreases to 9 characters per line
  221.  
  222.        (CONDENSED mode:
  223.         This is for printers that will do CONDENSED printing based on
  224.         the printer code: chr$(18) This is the most lettered line you
  225.         can get with a maximum of 56 characters.
  226.  
  227.         If in Graphics mode, Enlarged Mode decreases to 32 characters per line
  228.  
  229.        (UNDERLINED mode:
  230.         This is for printers that will do UNDERLINED printing with
  231.         the following codes:  chr$(27)+chr$(45)+chr$(1)
  232.  
  233.         If in Graphics mode, Enlarged Mode decreases to 19 characters per line
  234.  
  235.         This mode, like Normal, will print out 34 characters.
  236.  
  237.        (NORMAL mode:
  238.         This is regular print. This mode will print 34 characters.
  239.  
  240.         If in Graphics mode, Enlarged Mode decreases to 19 characters per line
  241.  
  242.  
  243.  
  244.    F2...Makes the default LABEL list, the one you specify. When
  245.         giving the list a name, you can enter up to 8 characters.
  246.         This name must not contain the characters "[]/\:;*." or a
  247.         space. If it does, the program will strip these characters
  248.         out. The name you give it will automatically be given the
  249.         extension .LST.
  250.  
  251.    F3...Lets you repeat the line, from the one above it.
  252.  
  253.    F4...Blank label. This prints a blank label, so it facilitates
  254.         easier removal of the regular printed labels.
  255.  
  256.    F5...Print Labels. This function has 4 modes. It defaults to
  257.         ABORT, but may be chosen to do AUTO, SINGLE, and MULTI.
  258.  
  259.         In AUTO mode, the program goes thru the current label list
  260.         for premade labels. When it finds one, It prints one label.
  261.         If graphics is enabled, (by pressing Alt-S) each label will
  262.         have the prechosen graphic on it.
  263.  
  264.         In SINGLE mode, one label is printed for the current label
  265.         being edited.
  266.         If graphics is enabled, (by pressing Alt-S) each label will
  267.         have the prechosen graphic on it.
  268.  
  269.         In MULTI mode, You may enter from 1-1000 labels here. However
  270.         many you choose it will print that many for the current edited
  271.         label. If you want to abort press [ESC] or [ENTER].
  272.         If graphics is enabled, (by pressing Alt-S) each label will
  273.         have the prechosen graphic on it.
  274.  
  275.         The printer must either emulate an Epson or IBM Graphics
  276.         printer, as those are the printers that the codes used for
  277.         specialized type is set to emulate. Check with your printer
  278.         manual before proceeding.
  279.  
  280.         If at any time the printer runs out of paper, or jams up, or
  281.         is Busy the program will halt until it becomes ready again.
  282.         In the event its out of paper or jammed, it will await for
  283.         you to press a key before proceeding.
  284.  
  285.    F6...Deletes Current line or if pressed twice will blank
  286.         entire label. This will also disable Graphics if pressed
  287.         twice.
  288.  
  289.    F7...Left/Center/Right. This will toggle your line between Left
  290.         justified, Centered, or Right Justified.
  291.  
  292.    F8...Help Screen.
  293.  
  294.    F9...Save or Load a label. If you try to load a label from a
  295.         newly created label list this process will return you to
  296.         editing. If you want to Save a label, you are prompted
  297.         to enter the name you wish to use for that label. The
  298.         name can be up to 20 character long. If that name is
  299.         currently in use, you will have the option of Overwriting
  300.         that label or create a new name.
  301.  
  302.         If you want to load a label, a list of the available labels
  303.         will list to the screen. Press the Cursor-Up or Cursor-Down
  304.         keys to select the label, then press Enter to load it. 
  305.  
  306.         To abort a save, press return at the name prompt or press
  307.         <ESC> at the Save or Load prompt.
  308.  
  309.    F10..To EXIT, press "Y" at the prompt. Any other key
  310.         will return you to Edit mode.
  311.  
  312.  Alt-G..Enter Graphics Mode. This will bring up a window which consists
  313.         of any Graphics Library files that exists in the same directory
  314.         you run Labler from. These Libraries must have the extension of 
  315.         .SDR(Graphics) & .SHP(Names). When a Library is chosen, you will
  316.         then be presented with a list of available graphics within that
  317.         library. If you don't want to pick one, choose "=NONE=" and this
  318.         mode will abort. If you want to pick one use the cursor keys to
  319.         choose the graphic. You will then see what the graphic will look
  320.         like. You will then have the opportunity to use the cursor keys
  321.         again to find the exact graphic you want.
  322.  
  323.  CTRL-G This will show you the graphic currently selected, if you are
  324.         using a graphic in the label.
  325.  
  326.  Alt-S..Toggles Sound mode ON/OFF. This will only turn off the Windowing
  327.         sounds. The keyclicking sound will still be on.
  328.  
  329.  
  330. Editing the Premade Labels within the List
  331. ------------------------------------------
  332.  
  333.         Since I have done away with the old PMEDIT program within the 
  334.         LABLER program, there had to be some way to edit the premade 
  335.         labels, and there is. I have written a small program that will
  336.         let you Delete or Sort the Labels within the list. An accompanying
  337.         program LABMAINT.EXE has been provided for limited maintenance
  338.         features. If you wish to sort the List, it will sort it by
  339.         the Name of the label. Also, before using LABMAINT, there are
  340.         is 1 requirement. You must either run this program on a data
  341.         disk with at least 2Meg bytes free. This is required because
  342.         LABMAINT makes a temporary file to sort & delete the list.
  343.  
  344.         One more note about Deleting labels. Try to delete all the
  345.         labels you want in one pass. Since it take roughly 2 minutes,
  346.         to read/write the labels to seperate files.
  347.  
  348. Graphics within Labler
  349. ----------------------
  350.  
  351.         Starting with version 7.3, I have made available a means of which
  352.         to add graphics. This is done with PrintMaster Icons because they
  353.         are the easiest to convert. As stated above, if a graphic is used
  354.         you will notice that the line lengths decrease dramatically. Try
  355.         to choose the graphic before creating the label to insure that
  356.         you have enough space for the words.
  357.  
  358.         When your graphic is printed it will be printed in the format below:
  359.                       -----------------------------
  360.                        ┌─────────┐ This is Line 1
  361.                        │         │ This is Line 2
  362.                        │ GRAPHIC │ This is Line 3
  363.                        │         │ This is Line 4
  364.                        └─────────┘ This is Line 5
  365.                       -----------------------------
  366.                         The box is usually not shown
  367.                         unless it's included with the
  368.                         graphic.
  369.  
  370. History of LABLER
  371. -----------------
  372.  
  373.         This program came into being, when I was working at a Computer 
  374.         Retail outfit. The old label making program was being run on a 
  375.         Commodore 64 and since I had gotten out of Commodore all together
  376.         and into IBM programming, I decided, out of something to do, to 
  377.         improve on that basic program. In it there was no way to edit, 
  378.         or add, or delete the premade labels without going directly into 
  379.  
  380.         the Source code and modifing it that way. I also experimented
  381.         with different types so that a good label would be outputted.
  382.  
  383.         When I started LABLER, It was a very basic BASIC program. I 
  384.         decided to use Turbo Basic because it used lots of different 
  385.         tools in it. And also it could be compiled into a Executable 
  386.         program, and since all my experience using Commodore basic, 
  387.         which is very similar to IBM basic, this was the perfect medium 
  388.         to do it with.
  389.  
  390.         I thought it would make a very professional looking package. 
  391.         Then it was only a project to work on, something to take the 
  392.         boredom out of testing the so many software and hardware I was 
  393.         expected to do at the company. But has since become one of my 
  394.         best efforts.
  395.  
  396.         It has gone through alot of changes, as I have. I quit working 
  397.         for that company where all this started. But my LABLER program is
  398.         still working there. The manager, who was my superior, is still 
  399.         communicating with me, and told me of the many bugs which he 
  400.         found, he is still my Beta tester. I know there is to be some 
  401.         bugs with the program, but until I got feedback on the program 
  402.         from the public, and my beta testers I would never have known 
  403.         the bugs.
  404.  
  405.         Versions up to v7.0 were all written using Borland's great
  406.         Turbo Basic. I have graduated now to a faster, more compact
  407.         language, Pascal. Since I had written all my previous versions
  408.         using Borland's compilers I stayed with them.
  409.         Before I decided on Turbo Pascal I looked at various other 
  410.         languages including 'C' and assembler. Turbo Pascal, even though 
  411.         not as widely used as 'C', is in my opinion far superior. 
  412.  
  413.         I switched to Turbo Pascal because for one thing it creates a 
  414.         smaller more compact program size and also because it's much faster.
  415.         Version 7.0, although not released, was my first attempt as a 
  416.         Turbo Basic to Turbo Pascal conversion.
  417.         (Well enough of the praise of Borland and their fine programs)
  418.  
  419.  
  420. Version History
  421. ---------------
  422.         Ver 1.0         February 1986
  423.                         First Version on a Commodore 64.
  424.         
  425.                         Bugs Reported:
  426.                         Centering / UnCentering Bug
  427.                         If no Label list found program would abort.
  428.  
  429.         Ver 5.0         January 1987
  430.                         First LABLER to introduce Windows
  431.                         Used ALT-Function keys to execute commands
  432.                         Fixed Previous Bugs.
  433.  
  434.         Ver 5.5         February 1988
  435.                         Updated so LABLER could save 10 labels.
  436.                         Include Help Screen
  437.  
  438.         Ver. 5.6        May 1988
  439.                         Included New Windowing techniques
  440.                         Decided on NON-ALT function keys to execute commands,
  441.                         since most other programs used the ALT-key functions.
  442.  
  443.         Ver. 5.7        October 1988
  444.                         Included Label list to be modified or
  445.                         labels to be deleted within.
  446.                         Updated so LABLER could save 1000 labels.
  447.  
  448.                         Bugs Reported:
  449.                         After deleting Labels, program would still show
  450.                         them.
  451.  
  452.         Ver. 5.8        February 19, 1989  
  453.                         Fixed Label List problem
  454.                         Included way to change Label Lists. (so in effect
  455.                         could have 1000 labels in each list.)
  456.                         Included Shell to DOS from program, for any type
  457.                         of DOS commands. 
  458.  
  459.         Ver. 5.9        February 28, 1989
  460.                         Fixed PMEDIT, internal LABLER list editor.
  461.                         Fixed Centering problem, found in Ver 5.8
  462.                         Fixed Insert Mode problem, found in Ver. 5.8
  463.  
  464.         Ver. 6.0        March 3, 1989 (Latest Release)
  465.  
  466.                         Fixed PMEDIT, internal LABLER list editor. Found
  467.                         that it did not actually delete label when re-
  468.                         quested.
  469.  
  470.         Ver. 6.3        July 1990.
  471.                         Minor bugs reported and fixed.
  472.  
  473.         Ver. 6.4        August 1990
  474.                         Never released.
  475.  
  476.         Ver. 7.0        October 3,1990
  477.                         First version of LABLER written in Turbo Pascal
  478.                         v5.5.
  479.                         Added Right Justification.
  480.                         Revised Labels list.
  481.                         Added Label List load at command line.
  482.                         Removed NLQ mode. (Might be available in later
  483.                         version). NLQ mode (thru printer controls) can
  484.                         still be used though.
  485.                         Added Monochrome and Composite Monitor Support.
  486.  
  487.         Ver. 7.1        Jan 19, 1991
  488.                         Fixed minor bugs.
  489.  
  490.         Ver. 7.2        Apr 8, 1991
  491.                         Added Auto-Mode, to Print Options,
  492.                         for entire list printing.
  493.                         Added Single Mode, to Print Options.
  494.                         Added 10K print buffer.
  495.                         Added Error detection for Printer.
  496.  
  497.         Ver. 7.3        Apr 24, 1991                              
  498.                         Added Graphics Capibilty. Uses Public Domain
  499.                         icons in PrintMaster Format for graphics.
  500.                         Removed SHELL to DOS command. This is because
  501.                         the Graphics Capibility uses alot more memory than
  502.                         previous versions.
  503.  
  504.         Ver. 7.4        May 30, 1991
  505.                         Fixed Home/End Graphics Bug.
  506.                         Fixed On-Screen Clock
  507.                         Fixed Help Window
  508.                         Fixed =NONE= Graphics Load
  509.                         Fixed <No Name> New List
  510.                         Added On/Off Sound Capibility
  511.                         Added On-Screen Sound Indicator
  512.                         Added On-Screen Graphics Mode Indicator
  513.  
  514.         Ver. 7.5        Fixed Duplicated Name bug.
  515.  
  516.         Ver. 7.6        Added No Pop Sounds when invoking.
  517.                         Added better Video Checking.
  518.                         Added Label List Maintenance program,
  519.                         (LABMAINT.EXE v7.6a)
  520.  
  521.         Ver. 7.7        Added Nextlabel LF option for setting
  522.                         lines between labels. (see below)
  523.                         ANSI Screen Background option.
  524.                         Added No ANSI option switch.
  525.  
  526.         Ver. 7.8        Substituted all command line options
  527.                         for /S for setup.
  528.  
  529.         Ver. 8.0        Feb.7, 1992
  530.                         Changed Data format (yes. again...)
  531.                         Included in new data format. Way to save
  532.                         graphics Image.
  533.                         added Function CTRL-G to display graphic
  534.                         saved, or selected.
  535.                         Added /L switch to create different sized
  536.                         list files.
  537.  
  538.         Ver. 8.1        Feb 10, 1992.
  539.                         Fixed minor bug in loading from list file.
  540.                         Added sample graphics in ARJ archive.
  541.  
  542.         Ver. 8.2        Feb 16, 1992
  543.                         Fixed major bug in loading from list file.
  544.                         (Would not pull in graphic pic from list)
  545.                         Fixed bug in LABMAINT.EXE. Would break with
  546.                         Runtime error, if trying to load a 1000 label
  547.                         list.
  548.  
  549.         Ver. 8.3        Feb 20, 1992
  550.                         Fixed minor CLEAR LABEL bug.
  551.  
  552.         Ver. 8.4        Fixed bug where Regular labels were printing
  553.                         on 1 line.
  554.  
  555.  
  556.  
  557. ===============================================================================
  558.  
  559.         This concludes the Documentation of LABLER.
  560.  
  561.         This Program was written on an THE PC+ (IBM XT Clone), with 
  562.         640K, and a EGA monitor.
  563.  
  564.         This program requires a Hard Drive (with at least 1.2Meg of
  565.         disk space) & 640K memory. (more if graphics are to be used)
  566.  
  567.         Any suggestions or ways to improve this program can be mailed to:
  568.  
  569.                                 Ken Koch
  570.                                 507 Whitten Rd.
  571.                                 Ingleside, IL
  572.                                            60041
  573.  
  574.